home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / programm.ing / rcs56.zoo / rcs / man / rcs.txt < prev    next >
Encoding:
Text File  |  1992-01-26  |  8.9 KB  |  331 lines
  1.  
  2.  
  3.  
  4. RCS(1)            Printed December 19, 1991           RCS(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      rcs - change RCS file attributes
  10.  
  11. SYNOPSIS
  12.      rcs [ options ] file ...
  13.  
  14. DESCRIPTION
  15.      rcs creates new RCS files or changes attributes of    existing
  16.      ones.  An RCS file    contains multiple revisions of text, an
  17.      access list, a change log,    descriptive text, and some
  18.      control attributes.  For rcs to work, the caller's    login
  19.      name must be on the access    list, except if    the access list
  20.      is    empty, the caller is the owner of the file or the
  21.      superuser,    or the -i option is present.
  22.  
  23.      Pathnames matching    an RCS suffix denote RCS files;    all
  24.      others denote working files.  Names are paired as explained
  25.      in    ci(1).    Revision numbers use the syntax    described in
  26.      ci(1).
  27.  
  28. OPTIONS
  29.      -i      Create and initialize    a new RCS file,    but do not
  30.       deposit any revision.     If the    RCS file has no    path
  31.       prefix, try to place it first    into the subdirectory
  32.       ./RCS, and then into the current directory.  If the RCS
  33.       file already exists, print an    error message.
  34.  
  35.      -alogins
  36.       Append the login names appearing in the comma-separated
  37.       list logins to the access list of the    RCS file.
  38.  
  39.      -Aoldfile
  40.       Append the access list of oldfile to the access list of
  41.       the RCS file.
  42.  
  43.      -e[logins]
  44.       Erase    the login names    appearing in the comma-separated
  45.       list logins from the access list of the RCS file.  If
  46.       logins is omitted, erase the entire access list.
  47.  
  48.      -b[rev]
  49.       Set the default branch to rev.  If rev is omitted, the
  50.       default branch is reset to the (dynamically) highest
  51.       branch on the    trunk.
  52.  
  53.      -cstring
  54.       sets the comment leader to string.  The comment leader
  55.       is printed before every log message line generated by
  56.       the keyword $Log$ during checkout (see co(1)).  This is
  57.       useful for programming languages without multi-line
  58.       comments.  An    initial    ci , or    an rcs -i without -c,
  59.       guesses the comment leader from the suffix of    the
  60.  
  61.  
  62.  
  63. Page 1                     TARGON /35     Operating System
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RCS(1)            Printed December 19, 1991           RCS(1)
  71.  
  72.  
  73.  
  74.       working file.
  75.  
  76.      -ksubst
  77.       Set the default keyword substitution to subst.  The
  78.       effect of keyword substitution is described in co(1).
  79.       Giving an explicit -k    option to co, rcsdiff, and
  80.       rcsmerge overrides this default.  Beware rcs -kv,
  81.       because -kv is incompatible with co -l.  Use rcs -kkv
  82.       to restore the normal    default    keyword    substitution.
  83.  
  84.      -l[rev]
  85.       Lock the revision with number    rev.  If a branch is
  86.       given, lock the latest revision on that branch.  If rev
  87.       is omitted, lock the latest revision on the default
  88.       branch.  Locking prevents overlapping    changes.  A lock
  89.       is removed with ci or    rcs -u (see below).
  90.  
  91.      -u[rev]
  92.       Unlock the revision with number rev.    If a branch is
  93.       given, unlock    the latest revision on that branch.  If
  94.       rev is omitted, remove the latest lock held by the
  95.       caller.  Normally, only the locker of    a revision may
  96.       unlock it.  Somebody else unlocking a    revision breaks
  97.       the lock.  This causes a mail    message    to be sent to the
  98.       original locker.  The    message    contains a commentary
  99.       solicited from the breaker.  The commentary is
  100.       terminated by    end-of-file or by a line containing . by
  101.       itself.
  102.  
  103.      -L      Set locking to strict.  Strict locking means that the
  104.       owner    of an RCS file is not exempt from locking for
  105.       checkin.  This option    should be used for files that are
  106.       shared.
  107.  
  108.      -U      Set locking to non-strict.  Non-strict locking means
  109.       that the owner of a file need    not lock a revision for
  110.       checkin.  This option    should not be used for files that
  111.       are shared.  Whether default locking is strict is
  112.       determined by    your system administrator, but it is
  113.       normally strict.
  114.  
  115.      -mrev:msg
  116.       Replace revision rev's log message with msg.
  117.  
  118.      -nname[:[rev]]
  119.       Associate the    symbolic name name with    the branch or
  120.       revision rev.     Delete    the symbolic name if both : and
  121.       rev are omitted; otherwise, print an error message if
  122.       name is already associated with another number.  If rev
  123.       is symbolic, it is expanded before association.  A rev
  124.       consisting of    a branch number    followed by a .    stands
  125.       for the current latest revision in the branch.  A :
  126.  
  127.  
  128.  
  129. Page 2                     TARGON /35     Operating System
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RCS(1)            Printed December 19, 1991           RCS(1)
  137.  
  138.  
  139.  
  140.       with an empty    rev stands for the current latest
  141.       revision on the default branch, normally the trunk.
  142.       For example, rcs -nname: RCS/* associates name with the
  143.       current latest revision of all the named RCS files;
  144.       this contrasts with rcs -nname:$ RCS/* which associates
  145.       name with the    revision numbers extracted from    keyword
  146.       strings in the corresponding working files.
  147.  
  148.      -Nname[:[rev]]
  149.       Act like -n, except override any previous assignment of
  150.       name.
  151.  
  152.      -orange
  153.       deletes ("outdates") the revisions given by range.  A
  154.       range    consisting of a    single revision    number means that
  155.       revision.  A range consisting    of a branch number means
  156.       the latest revision on that branch.  A range of the
  157.       form rev1:rev2 means revisions rev1 to rev2 on the same
  158.       branch, :rev means from the beginning    of the branch
  159.       containing rev up to and including rev, and rev:  means
  160.       from revision    rev to the end of the branch containing
  161.       rev.    None of    the outdated revisions may have    branches
  162.       or locks.
  163.  
  164.      -q      Run quietly; do not print diagnostics.
  165.  
  166.      -I      Run interactively, even if the standard input    is not a
  167.       terminal.
  168.  
  169.      -sstate[:rev]
  170.       Set the state    attribute of the revision rev to state .
  171.       If rev is a branch number, assume the    latest revision
  172.       on that branch.  If rev is omitted, assume the latest
  173.       revision on the default branch.  Any identifier is
  174.       acceptable for state.     A useful set of states    is Exp
  175.       (for experimental), Stab (for    stable), and Rel (for
  176.       released).  By default, ci(1)    sets the state of a
  177.       revision to Exp.
  178.  
  179.      -t[file]
  180.       Write    descriptive text from the contents of the named
  181.       file into the    RCS file, deleting the existing    text.
  182.       The file pathname may    not begin with -.  If file is
  183.       omitted, obtain the text from    standard input,
  184.       terminated by    end-of-file or by a line containing . by
  185.       itself.  Prompt for the text if interaction is
  186.       possible; see    -I.  With -i, descriptive text is
  187.       obtained even    if -t is not given.
  188.  
  189.      -t-string
  190.       Write    descriptive text from the string into the RCS
  191.       file,    deleting the existing text.
  192.  
  193.  
  194.  
  195. Page 3                     TARGON /35     Operating System
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. RCS(1)            Printed December 19, 1991           RCS(1)
  203.  
  204.  
  205.  
  206.      -Vn  Emulate RCS version n.  See co(1) for    details.
  207.  
  208.      -xsuffixes
  209.       Use suffixes to characterize RCS files.  See ci(1) for
  210.       details.
  211.  
  212. COMPATIBILITY
  213.      The -brev option generates    an RCS file that cannot    be parsed
  214.      by    RCS version 3 or earlier.
  215.  
  216.      The -ksubst options (except -kkv) generate    an RCS file that
  217.      cannot be parsed by RCS version 4 or earlier.
  218.  
  219.      Use rcs -Vn to make an RCS    file acceptable    to RCS version n
  220.      by    discarding information that would confuse version n.
  221.  
  222.      RCS version 5.5 and earlier does not support the -x option,
  223.      and requires a ,v suffix on an RCS    pathname.
  224.  
  225. FILES
  226.      rcs accesses files    much as    ci(1) does, except that    it uses
  227.      the effective user    for all    accesses, it does not write the
  228.      working file or its directory, and    it does    not even read the
  229.      working file unless a revision number of $    is specified.
  230.  
  231. ENVIRONMENT
  232.      RCSINIT
  233.       options prepended to the argument list, separated by
  234.       spaces.  See ci(1) for details.
  235.  
  236. DIAGNOSTICS
  237.      The RCS pathname and the revisions    outdated are written to
  238.      the diagnostic output.  The exit status is    zero if    and only
  239.      if    all operations were successful.
  240.  
  241. IDENTIFICATION
  242.      Author: Walter F. Tichy.
  243.      Revision Number: 5.6; Release Date: 1991/09/26.
  244.      Copyright O 1982, 1988, 1989 by Walter F. Tichy.
  245.      Copyright O 1990, 1991 by Paul Eggert.
  246.  
  247. SEE ALSO
  248.      co(1), ci(1), ident(1), rcsdiff(1), rcsintro(1),
  249.      rcsmerge(1), rlog(1), rcsfile(5)
  250.      Walter F. Tichy, RCS--A System for    Version    Control,
  251.      Software--Practice    & Experience 15, 7 (July 1985),    637-654.
  252.  
  253. BUGS
  254.      The separator for revision    ranges in the -o option    used to
  255.      be    - instead of :,    but this leads to confusion when symbolic
  256.      names contain -.  For backwards compatibility rcs -o still
  257.      supports the old -    separator, but it warns    about this
  258.  
  259.  
  260.  
  261. Page 4                     TARGON /35     Operating System
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. RCS(1)            Printed December 19, 1991           RCS(1)
  269.  
  270.  
  271.  
  272.      obsolete use.
  273.  
  274.      Symbolic names need not refer to existing revisions or
  275.      branches.    For example, the -o option does    not remove
  276.      symbolic names for    the outdated revisions;    you must use -n
  277.      to    remove the names.
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327. Page 5                     TARGON /35     Operating System
  328.  
  329.  
  330.  
  331. ə